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SECTION 1 
LANGUAGES AND LIBRARY PROGRAMS 



The programs in this section are contained in the Tymshare Library and the User Program 
Library (UPL). 6 

Most Tymshare Library programs are written by Tymshare and are documented in published 
manuals. Tymshare has committed its applications group to maintaining these programs. 

The program names are listed in the first column. Programs with names beginning with a 
Crosshatch (#) are contained in the User Program Library. Most of these programs were 
written by individuals outside Tymshare and are stored in this library for the convenience of 
Tymshare users. Tymshare tries to keep these programs in working condition. Users may 
request the symbolic versions of any of the UPL programs except those few whose program 
names are underlined. 

All of these library programs are called by typing their names in the EXECUTIVE. 

All new programs not documented in the previous Program Availability List are denoted by 
an asterisk (*) following the program name. 

The third column of this index indicates the source of documentation according to the 
following code: 



MANUAL Program has its own manual. 

SD Program is self-documenting. It either asks whether instructions are needed or 

accepts the command INSTRUCTIONS. 

BML Program is documented in the Tymshare Business Management Library Reference 

Manual, April 1971. 

IML Program is documented in the Tymshare Information Management Library 

Reference Manual, January 1973. 

STATLM Program is documented in the Tymshare Statistics Library Reference Manual, 

September 1971. 

EXEC Program is documented in the Tymshare EXECUTIVE Reference Manual, 

January 1971, and supplementary Systems Bulletins. 

CTC Program is documented in the Tymshare CTC Datapoint Cursor Program 

Reference Manual, March 1970. 

LTD. ED Currently, only rough documentation is available. 

TAPE Program is documented in the Tymshare Paper Tape Package Reference Manual, 

November 1971. 



AB # Program is described in an Applications Bulletin. 

LB # Program is described in a Language Bulletin. 

SB # Program is described in a Systems Bulletin. 

FII Program is documented in the Tymshare BATCH FORTRAN/FORTRAN II 

Reference Manual, March 1972. 

FIV Program is documented in the Tymshare BATCH FORTRAN IV Reference Manual, 

September 1972. 



To allow you to use the Tymshare libraries more easily, a standard set of commands has 
been added to many of the library programs. These programs print a colon (:) when they 
are called. The user may then type: 



CAPABILITIES Describes capabilities of the program. 

INSTRUCTIONS Describes how to use the program. 

HELP Prints a list of program commands and descriptions. 

RUN Executes the program. 

QUIT Leaves program, returns to EXECUTIVE level. 

Programming Languages and Text Editing 

ARPAS Assembly Language MANUAL 

BFORTRAN . . . BATCH FORTRAN IV MANUAL 

CAL Conversational Algebraic Language MANUAL 

DCAL Conversational Algebraic Language (DDI Version) MANUAL 

DDT Dynamic Debugging Tool for ARPAS MANUAL 

EDITOR General Text Editing Language MANUAL 

F2C FORTRAN II Compiler MANUAL 

F20S FORTRAN II Operating System MANUAL 

FOS BATCH FORTRAN II Operating System MANUAL 

FTC BATCH FORTRAN II Compiler MANUAL 

NARP New ARPAS MANUAL 

SBASIC SUPER BASIC MANUAL 

SFORTRAN . . . SUPER FORTRAN (Conversational FORTRAN IV) ... . MANUAL 

SNOBOL String-Oriented Symbolic Language MANUAL 

XCAL Conversational Algebraic Language (extended size DCAL) . MANUAL 

XDDT Dynamic Debugging Tool for NARP MANUAL 



APPEND 

CONVERT 

CREATE . 
DEFINE . 
MERGE . 
NOTE* . 
PERFORM* 
PURGE . 
REPLACE 
REPORT 
RETRIEVE 
SELECT . 
SORT . . 
UPDATE 
VERIFY 



Information Management Library 

Appends one file to another IML 

Converts an IML data base from one format or type to 

another AB #37 

Creates a data base to be used with other IML programs . . IML 

Defines description of files for other IML programs .... IML 

Merges two sorted files into one IML 

Prints text to terminal for documenting commands files . . IML 

Executes IML SAVE files IML 

Purges selected information from a file IML 

Replaces selected information on a file IML 

Report generation program IML 

Management information retrieval system MANUAL 

Selects specified records from a file IML 

Fast and flexible sorting program IML 

Updates selected information based on specified conditions . IML 

Verifies the data in a file used by other IML programs . . . IML 



Business Programs 

Property Management 

C1APTS .... Financial analysis of apartments MANUAL 



C1COND 

ClOFIC 

C2LUI 

C2PLAN 

CPEAP1* 



Financial analysis of projects for sale MANUAL 

Financial analysis of commercial buildings MANUAL 

Land use intensity (FHA Form 1028,1029) MANUAL 

Design statistics for land use studies MANUAL 

Real estate analysis package MANUAL 



Management 

C3CPM . . 
C3CPMF 

#CPM1 . . 

#CPM2 . . 

#CPM3 . . 

#CPMI . . 

FASTAB . 
INVENTORY 

LINPROG . 

#PERT . . 

TYMTAB . 

USPAVOT . 



. Critical path method scheduling MANUAL 

. Critical path method (expanded version) MANUAL 

. Critical path method phase 1 BML 

. Critical path method phase 2 BML 

. Critical path method phase 3 (used for making revisions) . . SD 

. Instructions for critical path method programs BML 

. Fast version of TYMTAB MANUAL 

. Facilitates inventory bookkeeping MANUAL 

. Extended linear programming MANUAL 

. Performs PERT network analysis BML 

. Powerful report/table generation MANUAL 

. Processes surveys 



MANUAL 



Finance 

#ANNUITY Calculation of annuities BML 

CASHMGT* Devises optimal short-term investment/borrowing 

strategy MANUAL 

C6JOBC Job cost accounting MANUAL 

#CASHFLOW Discounted cash flow BML 

#COSTSAVE Cost of making versus buying a product BML 

#DEPREC Four method depreciation on investment BML 

FINPAK Financial analysis package MANUAL 

#FINSTA Financial statement and report program SD 

#LESSOR Lease analysis from lessor's point of view BML 

#PORTMGT* Securities portfolio management system MANUAL 

#PRESVAL Rate of return on investments given a series of 

cash flows BML 

RISKAN Risk analysis program MANUAL 

#STOCKRETRIEVE* . . Daily securities prices MANUAL 

TYMKEEP General ledger accounting MANUAL 

Economics 

#FORECAST Trend analysis forecasting BML 

#TRENDANAL .... Forecast based on data with trend and/or seasonal 

effect SD 

#TRENDFORE .... Linear trend forecast SD 

Mortgage 

#MORTGAGE .... Yearly or monthly mortgage table BML 

Real Estate 

RANAL Investment analysis MANUAL 

REAIA Investment analysis MANUAL 

REAPA Project analysis MANUAL 

Statistics Programs 

General Statistics and Data Screening 

#BINDIS Binomial probability distribution STATLM 

#DESTAN Detailed statistical analysis on univariate data . . . STATLM 

GENIE Statistical analysis MANUAL 

#MANDSD Mean variance and standard deviation SD 

#STATANAL Statistical analysis STATLM 

#STATLINK Creates a STATPAK data file from a RETRIEVE 

data base STATLM 

STATPAK Comprehensive statistics package MANUAL 



Confidence Limits 



#COLINR . 
#MEANLIM 

#SIGNIF . . 



Confidence limits on a linear regression STATLM 

Mean, variance, standard deviation, and confidence 

limits STATLM 

Confidence limits on difference between two means . . . STATLM 



Correlation, Regression, and Curve Fitting 

#CURFIT . 
#CURVES . 



#LEAST . . 
#LINREG . 
#POLYCURV 
#STEPREG . 



Fitting a curve STATLM 

Fit data to six different curves SD 

Least error line fitting SD 

Simple linear regression SD 

Polynomial curve fitting STATLM 

Multiple regression analysis with step technique to add 

variables STATLM 



Analysis of Variance 

#ONEWAY .... Analysis of variance 



STATLM 



Random Number Generators 

#RANDOMINT . . Generates list of random numbers 



SD 



Circuit Design/Synthesis 

AC-CODED 
ACSEQ . . 
#BODEPLOT 
CIRCAC . 
CIRCDC . 
DC-CODED 
DCSEQ . 
ECAP . . 



FILSYN . 

#NASAP . 
#RCFILT 
SCIRCAC 
SCIRCDC 



Electrical Engineering 



AC circuit analysis MANUAL 

Used with CIRCAC user-defined subroutines MANUAL 

Solution of transfer function of a circuit or network . . SD 

AC circuit analysis with built-in transistors MANUAL 

Nonlinear DC circuit analysis with built-in transistors . . MANUAL 

Nonlinear DC analysis with built-in transistors MANUAL 

Used with CIRCDC user-defined subroutines MANUAL 

Electronic circuit analysis (linear AC, DC, and 

Transient) MANUAL 

Synthesizes equal ripple and maximally flat low, high, 

and bandpass filters MANUAL 

Linear network analysis by S-plane method MANUAL 

RC active filter synthesis SD 

Used with CIRCAC user-defined subroutines MANUAL 

Used with CIRCDC user-defined subroutines MANUAL 
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TR-CODED . . . Transient circuit analysis with nonlinear elements 

and plotting MANUAL 

#TYMTRAC . . . Transient circuit analysis with nonlinear elements 

and semiconductor library MANUAL 

TRAP * Linear circuit analysis program MANUAL 



Reliability Analysis 

RADAC R.A.D.C. Notebook #2 for Reliability Prediction .... MANUAL 

RELAN Reliability Analysis MANUAL 

Logic Design and Analysis 

LOGMIN Logic minimization MANUAL 

LOGSIM Logic simulation with propagation delays MANUAL 

Microwave Analysis 

MICAP Microwave circuit analysis program MANUAL 

MICLIB Makes MICAP user-defined subroutines See MICAP 

Mathematical Methods 

LAPLACE .... LaPlace transform inversion program (see Fourier 

analysis under Mathematics Programs, also) MANUAL 



Civil Engineering 

Civil and Structural Engineering 

C4HEAT Calculates the heat loss, or heating loads, for buildings . MANUAL 

C2PLOT Plotting program for land use studies MANUAL 



Chemical Engineering 

#VIGAS Gas chromatography analysis of data from VIDAR 

AUTOLAB SD 



CSMP 



System Simulation 

Continuous system modeling program 



MANUAL 



Calculator 

CALCULATOR . 



Simulates a calculating machine SD 



ACPLOT . . . 
#CURFITPLOT 
#EASYDEMO 

#EASY30 . 
#EASYPLOT 
#EZGRAF . 
#PLOTEASY 
EASYPLOT 



Graphics/Plotting 

Plots output of AC-CODED NONE 

Creates plot of #CURFIT data SD 

Plotting demonstration file for # EASYPLOT NONE 

30 cps EASYPLOT for Zeta plotters NONE 

All-purpose plotting on incremental plotter MANUAL 

EASYPLOT package for the Typagraf SD 

Conversational front end to write EASYPLOT programs . SD 

10/30 cps all-purpose plotting for Zeta plotters .... NONE 



Tape Conversion 

#ASCII . 
#BCD . . 

BINTAPE 

CONFILE 

CONTAPE 

#EBCDIC 

#FLEXIN 
#FLEXOUT 

#INTAPE 
#OUTTAPE 



Utility Programs 



Conversion table — ASCII, external to internal TAPE 

Converts 029 punched card file to 026 punch 

compatibility SD 

Punches paper tape from or reads tape into a binary 

file TAPE 

File-to-tape conversion by user-written table TAPE 

Tape-to-file conversion by user-written table TAPE 

Converts BCD 026 punched files to 029 punch 

compatibility SD 

Converts flex coded tape to ASCII and input to disk file . SD 
Converts ASCII file to flexowriter code and punches 

tape SD 

Tape-to-file code converter SD 

File-to-tape code converter SD 



TABLEMAKER 

TABONE . . 
TAPE .... 
#TAPECON. . 

TITLE . . . 



Creates table for use with the programs CONFILE and 

CONTAPE TAPE 

Conversion table — code number is its position NONE 

Punches paper tape from or reads tape into symbolic file . . TAPE 

Reads paper tape and writes character numeric equivalent 

to file and vice versa SD 

Punches readable text on paper tape SD 



Format Conversion 
#ALIGN . . . 

#FCONVERT . 
#STRIP . . . 



Prints SUPER BASIC or BATCH FORTRAN programs 
in readable form 



Conversion of free format FORTRAN IV to card image 
Strips trailing blanks and columns 72—80 from cards . 



SD 
SD 
SD 



Language Conversion 

FSB Optimizes SBASIC programs MANUAL 

#GETYMB . . Converts GE BASIC to Tymshare SBASIC SD 

#GETYMF . . Converts GE FORTRAN to Tymshare SFORTRAN . . . . SD 



Machine Languages 
SYMSORT . . 



Sorts and creates file of program labels for ARPAS 
program 



SD 



Text Manipulation Programs 

FET File editing tool NONE 



LNED 



Line editor MANUAL 



Programming Aids 

BFBED . . 
BFMACRO . 
F2BED . . 
#GETSSP . 

#IOBIN . . 
#LIBLD . . 
MAKEGO . 



BATCH FORTRAN IV binary editor MANUAL 

BATCH FORTRAN IV macros for NARP subroutines . . . MANUAL 

FORTRAN II binary editor FII 

Prints symbolics of FORTRAN II subroutines in 

SPMATH, SPMATR, and SPSTAT SD 

Binary input/output routine SD 

BATCH FORTRAN II library builder FII 

Transforms SFORTRAN link files into GO files NONE 
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Debugging Aids 

#BINDUMP 
SBIG . . . 



Print contents of binary file in ASCII, HEX, or OCTAL . . SD 
SUPER BASIC index generator LB #5 



File Utility Programs 

AFD . 
FDM . 
NET . 
#PRINT 
SETS . 
TELECOPY 



Automatic file deletion EXEC 

File directory management — compacts files SD 

Copies a file from one TYMCOM-X system to another . . . SD 

Prints files in various formats MANUAL 

Sets maximum allowable file size EXEC 

Copies a file from one computer to another SD 



Security 

CIPHER . . 
CHECKSUM 
COMPARE . 
FAILSAFE . 
PASSWORD 
SCOMPARE 
SETFAILSAFE 
VALID . . 
VERIF . . 



Enciphers or deciphers a file EXEC 

Computes unique file identification number EXEC 

Compares any two files EXEC 

Protection from phone disconnects EXEC 

Changes password EXEC 

Compares any two symbolic files and prints all differences . EXEC 

Invokes failsafe feature EXEC 

Sets up requirement for project code validation NONE 

Prints checksums for entire directory EXEC 



Terminal Input/Output 

FDX Puts user in full-duplex mode EXEC 

HDX Puts user in half-duplex mode EXEC 

TERMINET . . Sets system I/O parameters for GE Terminet NONE 



BATCH . . 
COPYBATCH 



User Information and Assistance 

Requests jobs to be done by computer center MANUAL 

Used with BATCH. Transfers user's file to operator's 

file directory MANUAL 

NAMES .... Types all user names in account EXEC 

NONAME . . . User validation program SD 

OFF Turns off selected features SD 

ON Turns on selected features SD 

POSTMAN . . . Prints mail information EXEC 

PREMIUM . . . Lists royalty program premium charges SD 
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SUMMARY 
TYMUSE 
WHY . . 



Disk storage summary EXEC 

Accounting data regarding use of Tymshare system . . . MANUAL 
Further explains some system error messages EXEC 



Demonstration Programs 



. The battle of numbers SD 

. Computer deals BLACKJACK SD 

. Jug and Bottle game SD 

. Performs a card trick SD 

. Game of DICE SD 

. Game of FOOTBALL SD 

. Game of GOLF SD 

. Game of GOMOKU SD 

. Game of KENO SD 

. Game of NIM SD 

. Computer deals draw POKER SD 

#QUBIC Three-dimensional TIC-TAC-TOE SD 

#ROULETTE . . . Game of ROULETTE SD 

#SLOT Game of SLOT MACHINE SD 



#BATNUM . 
#BLACKJACK 
#BOTTLE . 
#CARDTRICK 
#DICE . . 
#FOOTBALL 
#GOLF . . 
#GOMOKU 
#KENO . . 
#NIM . . . . 
#POKER . . 



PRINTER . 



Remote Peripheral Access 

General-purpose printer program . 



MANUAL 
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SECTION 2 
BATCH FORTRAN LIBRARY ROUTINES 



A number of library functions and subroutines are available in BATCH FORTRAN II. 
Standard library functions - SIN, COS, etc. - are stored on a file named *LIB. The compiled 
functions and subroutines described in this section are on the following files: 

*FSUBR General subroutines. 

#EXL2 Additional general subroutines. (#EXL4 contains a similar library for 

BFORTRAN4.) 

#SPSTAT Statistical subroutines. 

#SPMATR Matrix subroutines. 

#SPMATH Mathematical subroutines. 

In addition, Tymshare offers BATCH FORTRAN II subroutines to control incremental 
plotters. The Zeta plotter routines are on the file *ZLIB, and the routines for CalComp and 
similar plotters are on the file *PLIB. 

All BATCH FORTRAN II subroutines are documented in the Tymshare BATCH FORTRAN/ 
FORTRAN II Reference Manual. These subroutines are used in BATCH FORTRAN II in a 
CALL statement. The user's main program is compiled in FTC. The user calls FOS, enters 
the name of his compiled main program, and then enters the name of the required subroutine 
files. 

Symbolics for the BATCH FORTRAN II subroutines on the files #SPSTAT, #SPMATR, and 
#SPMATH can be obtained by typing #GETSSP in the EXECUTIVE. For example: 

- #GETSSP ^> 

WHAT ROUTINE DO YOU WISH? subroutine name -, 

NAME YOUR FILE? filename^ 

***SSP PROGRAM subroutine name IS WRITTEN ON FILE filename*** 

These symbolics can be used in SUPER FORTRAN with only minor changes. The procedure 
used is as follows: 

1. The user writes the symbolics of the subroutine on a file using the program #GETSSP. 

2. He strips off the trailing blanks with the #STRIP program. 

3. He enters the program into SUPER FORTRAN with the COPY command. 

In BATCH FORTRAN II, continuation of a statement to the next line is indicated by a 
character in column 6. In SUPER FORTRAN, the continued lines are separated by Line Feeds 
rather than by Carriage Returns. Therefore, all continued lines in the subroutine need a Line 
Feed instead of a Carriage Return, and the character in column 6 must be removed. The JOIN 
command in EDITOR may be used to join two lines with a Line Feed between them. 
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Statistics Programs 



General Statistics and Data Screening 

Totals, means, standard deviations, minima, and maxima . . . TALLY 

Selections of observations within bounds BOUND 

Subset selection from observation matrix SUBST 

Detection of missing data ABSNT 

Tabulation of data in one variable TAB1 . 

Tabulation of data in two variables TAB2 . 

Building subset matrix SUBMX 

First four moments MOMEN 

Test on population means TTSTT 

Correlation, Regression, and Curve Fitting 

Data generation GDATA 

Multiple regression and correlation MULTR 

Rearrangement of intercorrelations ORDER 

Means, standard deviations, and correlations CORRE 

Canonical correlations CANOR 

Analysis of Variance 

Data storage allocation AVDAT 

Sigma and del operations AVCAL 

Mean square operation MEANQ 

Discriminant Analysis 

Means and dispersion matrix DMATX 

Discriminant functions DISCR 

Factor Analysis 

Cumulative percentage of eigenvalues TRACE 

Factor loading LOAD 

Varimax rotation VARMX 



#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 



#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 



#SPSTAT 
#SPSTAT 
#SPSTAT 



#SPSTAT 
#SPSTAT 



#SPSTAT 
#SPSTAT 
#SPSTAT 
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Time Series 

Autocovariances AUTO 

Cross covariances CROSS 

Application of filter coefficients SMO . 

Triple exponential smoothing EXSMO 

Special Statistical Routines 

Spearman rank correlation SRANK 

Kendall rank correlation KRANK 

Chi-square test for a contingency table CHISQ 

Cochran Q-test QTEST 

Rank observations RANK 

Calculation of ties in ranked observations TIE . . 

Friedman two-way analysis of variance TWOAV 

Mann-Whitney U-test UTEST 

Kendall coefficient of concordance WTEST 

Gaussian normal probability integral function PROBIN 

Gaussian normal probability ordinate function GAUSS 

Random Number Generators 

Uniform random numbers RANDU 

Normal random numbers GAUSS 



#SPSTAT 
#SPSTAT 
#SPSTAT 
#SPSTAT 



#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

#SPSTAT 

*FSUBR 

*FSUBR 



#SPSTAT 
#SPSTAT 



Mathematics Programs 

Matrices 

Matrix addition subroutine RMADD 

Matrix subtraction subroutine RMSUB 

Matrix multiplication subroutine RMMUL 

Matrix transposition subroutine RMTRA 

Matrix inversion and rank calculation subroutine RMINV 

Matrix inversion and determinant calculation subroutine . . . INVERT 

Determinant evaluation function DETERM 

Addition of two general matrices GMADD 

Subtraction of two general matrices GMSUB 

Product of two general matrices GMPRD 

Transposition of a general matrix GMTRA 



*FSUBR 

♦FSUBR 

*FSUBR 

*FSUBR 

♦FSUBR 

♦FSUBR 

♦FSUBR 

#SPMATR 

#SPMATR 

#SPMATR 

#SPMATR 
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Transposition of the product of two general matrices GTPRD 

Addition of two matrices MADD 

Subtraction of two matrices MSUB . 

Row into column matrix product MPRD . 

Matrix transposition MTRA . 

Transposition of a product TPRD . 

Transposition of a product of a matrix by itself MATA . 

Addition of a scalar to a matrix SADD . 

Subtraction of a scalar from a matrix SSUB . 

Matrix multiplied by a scalar SMPY . 

Matrix divided by a scalar SDIV . 

Matrix clear and add scalar SCLA . 

Replace diagonal with scalar DC LA . 

Addition of row of one matrix to row of another matrix .... RADD . 

Addition of column of one matrix to column of another matrix . . CADD . 

Scalar multiply one row and add to another row SRMA . 

Scalar multiply one column and add to another column .... SCMA . 

Interchange two rows RINT . 

Interchange two columns CINT . 

Sum the rows of a matrix RSUM . 

Sum the columns of a matrix CSUM . 

Tabulation of the rows of a matrix RTAB . 

Tabulation of the columns of a matrix CTAB . 

Sort of matrix rows RSRT . 

Sort of matrix columns CSRT . 

Partition a matrix by rows RCUT . 

Partition a matrix by columns CCUT . 

Adjoin two matrices by rows RTIE . 

Adjoin two matrices by columns CTIE . 

Copy a matrix MCPY . 

Copy submatrix from given matrix XCPY . 

Copy row of matrix into vector RCPY . 

Copy column of matrix into vector CCPY . 

Copy diagonal of matrix into vector DCPY . 

Storage conversion MSTR . 

Matrix transformation by a function MFUN . 

Reciprocal function for MFUN RECP . 

Location in compressed stored matrix LOC 

Vector storage double dimensioned storage conversion ARRAY 

Matrix inversion MINV . 

Real matrix inversion MINV2 

Eigenvalues and eigenvectors of a real symmetric matrix .... EIGEN 

Eigenvalues and eigenvectors of a special nonsymmetric matrix . . NROOT 



#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATH 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPMATR 
#SPSTAT 
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Fourier Analysis 

Fourier analysis of a given function FORIF . . . #SPMATH 

Fourier analysis of a tabulated function FORIT . . . #SPMATH 

Integration 

Definite integral evaluation INTEGR . . *FSUBR 

Integral of tabulated function by quadrature QATR . . . #SPMATH 

Integral of given function by Simpson's rule QSF .... #SPMATH 

Double integration by Simpson's rule SIMPDBL . *FSUBR 



Differential Equations 

Runge-Kutta integral solution of differential equations RK . . 

Solution of differential equations by Runge-Kutta-Gill 

method RKINIT 

Solution of differential equations by Runge-Kutta-Gill 

method RKSTEP 

Integration of first-order differential equation by Runge- 
Kutta-Gill method RK1 . 

Tabulated integral of first-order differential equation by 

Runge-Kutta-Gill method RK2 . 

Tabulated integral of a system of six first-order differential 

equations RKGS . 



*FSUBR 

*FSUBR 

*FSUBR 

#SPMATH 

#SPMATH 

#SPMATH 



Linear Equations 

Solution of simultaneous linear algebraic equations 



SIMQ 



#SPMATR 



Nonlinear Equations 

Refining estimate of root by Wegstein's iteration RTWI 

Determining root within a range by Mueller's iteration .... RTMI 

Refining estimate of root by Newton's iteration RTNI 



#SPMATH 
#SPMATH 
#SPMATH 



Polynomials 

Real and complex roots of a real polynomial POLRT 

Addition of polynomials PADD 

Subtraction of polynomials" PSUB 

Multiplication of polynomials PMPY 

Division of polynomials PDIV 

Replacing one polynomial by another PC LA 



#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
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Multiplication by constant and addition to another 

polynomial PADDM 

Value of a polynomial PVAL . 

Substitution of variable of polynomial by another 

polynomial PVSUB 

Evaluation of polynomial and its first derivative PILD . 

Derivative of a polynomial PDER . 

Integral of a polynomial PINT . 

Quadratic synthetic division of a polynomial PQSD . 

Complete linear synthetic division PCLD . 

Greatest common divisor of two polynomials PGCD . 

Normalization of a coefficient vector of a polynomial .... PNORM 



#SPMATH 
#SPMATH 

#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 
#SPMATH 



Special Functions 

Bessel function subroutine BESSEL . 

Bessel calculation subroutine BESJY 

J Bessel function BESJ . . 

Y Bessel function BESY . . 

I Bessel function BESI . . 

K Bessel function BESK . . 

Elliptic integral of the first kind CEL1 . . 

Elliptic integral of the second kind CEL2 . . 

Exponential integral EXPI . . 

Sine cosine integral SICI . . 

Fresnel integrals CS ... 

Hyperbolic sine function HSIN . . 

Hyperbolic sine function HSIN . . 

Hyperbolic cosine function HCOS . . 

Hyperbolic cosine function HCOS . . 

Hyperbolic tangent function HTAN . . 

Complex sine function CSIN . . 

Complex cosine function CCOS . . 

Gamma function GAMMA . 

Legendre polynomial LEP . . . 

Legendre polynomial function P . . . . 

LaGrange interpolation subroutine INTERPOL 

Performs logical AND between two integers IAND . . 

Performs logical EXCLUSIVE-OR between two integers . . . IEOR . . 

Performs logical OR between two integers IOR . . . 

Complex multiplication for BATCH FORTRAN II CMULT . 

Complex division for BATCH FORTRAN II CDIV . . 

Complex absolute value for BATCH FORTRAN II CABS . . 



♦FSUBR 

♦FSUBR 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

#SPMATH 

♦FSUBR 

#EXL2 

* FSUBR 

#EXL2 

♦FSUBR 

#EXL2 

#EXL2 

#SPMATH 

#SPMATH 

♦FSUBR 

♦FSUBR 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 . 

#EXL2 
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Complex exponential function for BATCH FORTRAN II .... CEXP . 

Complex logarithm function for BATCH FORTRAN II CLOG . 

Complex square root for BATCH FORTRAN II CSQRT 



#EXL2 
#EXL2 

#EXL2 



Utility Programs 

Block data input or output BLKIO 

Opens a file using a name in an array of A3 integers OPEN . 

Opens a file whose name is stored in array AOPEN 

Deletes a file during program execution ADLETE 

Clears the terminal input buffer CIB . . 

Closes a command file which called the program in which it is 

used CLCOM 

Gets the system COM file number for use in the FORTRAN 

program that called it COM . 

Interrupts on an Alt Mode and transfers to a predefined 

instruction ESCAPE 

Cancels the effect of Escape and returns Escape control to 

BATCH FORTRAN II ESCRES 

Packs three characters into one word when they were input 

into an Al or 1H format PACK . 

Exits to EXECUTIVE but leaves all files open; on CONTINUE, 

control is returned to call QUIT . 

Reformats a floating point word into an alpha array and 

inserts commas RFMT . 

Fast algorithm to sort a floating point array SORT . 

Allows BATCH FORTRAN II to read SFORTRAN or 

SBASIC binary files SWITCH 

Test input buffer for input waiting TEL 

Unpacks a three-character A3 integer into three Al integer 

words UNPACK 

Numeric free form input routine VALUE 

Executes any user status BRS BRS 

Defines an array in terms of string pointers STRP . 

Stores an integer in a decimal location in core STORE 

Permits user-controlled interrupts ALTMODE 

COMMON swapping subroutine COMSWAP 

Return to EXECUTIVE from FOS DISMISS 

Suppresses the echo during terminal input ECHOFF 

Returns Teletype input to normal echo mode ECHON 

Creates pause in program execution WAIT . 

Reads TS page RDTSP 



#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 

#EXL2 
#EXL2 

#EXL2 
#EXL2 
#EXL2 

#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 
#EXL2 
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SECTION 3 
FORTRAN II LIBRARY ROUTINES 



The following subroutines are used with F20S and F2C. The routines NSWAP, OVERLAY, 
and COMSWAP each include a number of associated routines. All routines are documented in 
the Tymshare BATCH FORTRAN/FORTRAN II Reference Manual. 



CalComp plotter routine AXIS . 

CalComp plotter routine NUMBER 

CalComp plotter routine LINE 

CalComp plotter routine • SCALE 

CalComp plotter routine SYMBOL 

CalComp plotter routine PLT 

Uniform random number generator RANDU 

Gaussian random number generator GAUSS 

Simpson's rule integration SMPSN 

Polynomial evaluation PVAL . 

Arctangent function AT AN . 

Arctangent function AT AN . 

Gamma function GAMMA 

Matrix inversion and determinant computation MINV . 

Runge-Kutta integration of first-order differential equation RUNGK 

Integration of tabular function QUADR 

Eigenvalues and eigenvectors EIGEN 

Integration by Gaussian quadrature GAUQUA 

Error function ERFN . 

Bessel function BESSEL 

Complex addition CADD . 

Complex subtraction CSUB . 

Complex multiplication CMUL . 

Complex division CDIV . 

Polar to rectangular form CRECT 

Rectangular to polar form CPOLAR 

Complex number to real power CPOWER 

Absolute value of a complex number CABS . 

Roots of a polynomial POLRT 

Roots of simultaneous equations SIMQ . 

Roots of simultaneous equations SIMQ . 

Least squares fit to a polynomial LSQF . 

Newton's method for finding the root of a nonlinear equation . . . RTNI . 



*FLP 
*FLP 
*FLP 
*FLP 
*FLP 
*FLP 
*FL2 
*FL2 
*FL2 
*FL2 
*FL2 
*FL3 
*FL2 
*FL2 
*FL2 
*FL2 
*FL2 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL3 
*FL4 
*FL4 
*FL4 
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Obtaining the date and the time TIME . 

Subroutine for entering the name of an input/output file 

during program execution OPEN . 

Comparing floating point quantities IF . . 

Comparing floating point quantities IFF . . 

Fourier analysis of a given function in tabular form FORTB 

Copying files in a FORTRAN program COPY . 

Fourier analysis of a given function FOURFN 

Second-order ordinary differential equations RUNG2 

Routines for doing program overlays 

Routines for doing program overlays 

Routines for doing COMMON swapping 

File identification as to type FILEID 

Opening a file whose name is stored in an array AOPEN 

Stopping computation for specified time WAIT . 

Accepting a line in A format with editing EDCEPT 

Control of Escapes ESCAPE 

Reading binary paper tapes in FORTRAN RTBIN 

Reading binary paper tapes in FORTRAN INIRTB 

Reading binary paper tapes in FORTRAN ICTRTB 

Inputting one character at a time ONECHR 

Fast Fourier transform FOURT 

Fast Fourier transform FOUR2 

Fast Fourier transform FOUR1 

Random file processing routines 

Prereads next character in a file NEXTC 

Prereads next character in a file NXTCHR 

Allows execution of user status BRS BRS 

Causes return to EXECUTIVE level EXIT . 

Turns ACCEPT bell signal on or off BELL . 

Compares floating point Hollerith data COMPAR 

Returns core address of specified variable LOCF . 

Lists missing routines during F20S loading 



*FL1 

*FL5 

*FL1 

*FL2 

*FL4 

*FL1 

*FL4 

*FL4 

♦OVERLAY 

*NSWAP 

*COMSWAP 

*FL5 

*FL5 

*FL5 

*FL5 

*FL5 

*FL5 

*FL5 

*FL5 

*FL5 

*FL4 

*FL4 

*FL4 

*FL5 

*FL5 

*FL5 

*FL5 

*FL1 

*FL1 

*FL1 

*FL1 

*LIBEND 
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SECTION 4 
BATCH FORTRAN IV LIBRARY ROUTINES 



The basic BATCH FORTRAN IV functions are contained on the file *BFL. Additional 
subroutines, contained on the files *BFL1 and *BFL2, are listed in the following tables. 
These routines are documented in the Tymshare BATCH FORTRAN IV Reference Manual, 



*BFL1 - Mathematics and Statistics 

Least squares fit to a polynomial LSQF 

Matrix inversion and determinant calculation MINV 

Eigenvalues and eigenvectors EIGEN 

Root of a nonlinear equation RTNI 

Simultaneous equations SIMQ 

Roots of a polynomial POLRT 

Polynomial evaluation PVAL 

Second-order ordinary differential equation RUNG2 

Fourier analysis of a function FOUR FN 

Fourier analysis of a tabulated function FOURTB 

Fourier transform FOURT 

Fourier transform FOUR1 

Fourier transform FOUR2 

Bessel function BESSEL 

Gamma function GAMMA 

Error function ERFN 

Random number generator RANDU 

Random number generator GAUSS 

Floating point quantities comparison IFF 

Simpson's rule integration SMPSN 

Integration of tabular values QUADR 

Gaussian quadrature GAUQUA 

Runge-Kutta integration RUNGK 
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* 



BFL2 - Utility 

CalComp plotter subroutine AXIS 

CalComp plotter subroutine NUMBER 

CalComp plotter subroutine LINE 

CalComp plotter subroutine SCALE 

CalComp plotter subroutine SYMBOL 

CalComp plotter subroutine PLOTS 

CalComp plotter subroutine WHERE 

CalComp plotter subroutine OFFSET 

CalComp plotter subroutine PLOT 

CalComp plotter subroutine FACTOR 

Multiple sort MSORT 

Fast sort SORT 

Temporary computation halt WAIT 

Single character input ONECHR 

Edited text input EDCEPT 

File type determination FILEID 

Date and time TIME 

File copying during execution COPY 

Binary tape input RTBIN 

Binary tape input INTRTB 

Binary tape input ICTRTB 



#XBFL 

Many other useful subroutines have been written and are stored on file #XBFL. Preliminary 
documentation is available through your Account Representative. The routines are described 
below. 



Strings 



Converts integer to string, and vice versa CONV 

Places current date and time in a string DATIM 

Converts lower case alphabetic characters to upper case UC 

Strips off trailing blanks in a string STRIP 

Reverses the characters of a string REV 

Given a string, replaces one substring with another REPLAC 
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Files 



Gets file name from file directory GFNAME 

Computes checksum of a file CHECKSUM 

Renames a file RENAME 

Deletes a file whose name is stored in an array IADEL 



Input/Output 

Gets the next character (no restrictions) from a file GETNC 

Gets terminal characteristics GETTC 

Sets terminal characteristics SETTC 

Turns off (or on) the normal echoing of characters ECHO 

Changes manner in which system handles lower case LOCASE 

Halts execution until output buffer is empty OUTBUF 

Clears output buffer CLOB 

Checks input buffer for characters CHIB 

Clears input buffer CLIB 

Turns eight-level output on or off (normal) L80UT 



Others 



Sets a value into a word, at specified bit locations SETBIT 

Gets a number (specified by bit range) from within an integer word . GETBIT 

Gets current total CPU time CPU 

Reads internal system clock CLTICK 

Halts execution for specified amount of time WAIT 

Gets user status and universal user number STATUS 

Enables execution of any user-status BRS BRS 
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SECTION 5 
EXTENDED CAL FUNCTION LIBRARY 



The Extended CAL function library contains XCAL and DCAL programs developed to solve 
common computational problems. To use these programs, the user loads the appropriate file 
into his program. Thereafter, the library functions are used like ordinary user-defined functions 
with the arguments enclosed in square brackets. 

For further information about these programs, refer to the Tymshare Extended CAL Reference 
Manual. 



Statistics 

Calculates mean of a sample MEAN . . . #STATPAK 

Calculates variance of a sample VAR . . . #STATPAK 

Calculates standard deviation SIGMA . . #STATPAK 

Calculates estimated population variance EPV .... #STATPAK 

Least squares fit to a polynomial LSF .... #LSF 

Mathematics 

Inverse of a matrix INV .... #MATINV 

Computes the value of a determinant DET .... #DET 

Finds the real or complex roots of a quadratic equation . . . QUAD . . . #QUAD 

Solves a system of linear equations LQS .... #LQS 

Evaluates a definite integral by Simpson's rule INT .... #INT 

Calculates factorial of N FACT . . . #FPC 

Calculates permutations of N things taken R at a time .... PERM . . . #FPC 

Calculates combinations of N things taken R at a time . . . COMB . . . #FPC 

Arctangent function ATN . . . #ATN 

Arcsine function A8 . . . . #CATAN 

Arctangent function A9 . . . . #CATAN 

Bessel function of the first kind JNB ... #DBESSEL 

Bessel function of the second kind YNB . . . #DBESSEL 

Modified Bessel function of the first kind INB . . . #DBESSEL 

Modified Bessel function of the second kind KNB . . . #DBESSEL 

Computes value of a Bessel function J #BESSELCAL 

Plotting 

Plots graphs on terminal DPLOT . . #DPLOT 



